<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.

-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>JMS Resource General Attributes</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>

<body>
<p><a id="AS_Wiz_JMS_general" name="AS_Wiz_JMS_general"></a></p>
<div id="NBCSH4842"><!-- infolevel="all" infotype="General" --><a id="sthref702" name="sthref702"></a>
<h1>JMS Resource General Attributes</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>You see this page of the New File wizard when you are defining a JMS resource. On this page you choose to create either an Admin Object resource (destination) or a Connector resource (connection factory), and specify the JNDI name of the resource. 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1705">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<p><b>Note</b>: A JMS application normally uses at least one connection factory and at least one destination. The order in which these are created is not important.</p>
<p>Enter the configuration information for the resource.</p>

<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="22%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t74">Element</th>
<th align="left" valign="bottom" id="r1c2-t74">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t74" headers="r1c1-t74">
<p>JNDI name</p>
</td>
<td align="left" headers="r2c1-t74 r1c2-t74">The JNDI name for the resource is required and must be unique to this resource. Because all resource JNDI names are in the java:comp/env subcontext, when you specify the JNDI name of a JMS resource enter only jms/name. For example, specify jms/ConnectionFactory1. You cannot change the JNDI name of the resource after it has been registered with the server. To change the JNDI name, you must delete the resource from the server, after which you can change the JNDI name in the properties window of the resource and register the resource again.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t74" headers="r1c1-t74">
<p>Enabled</p>
</td>
<td align="left" headers="r3c1-t74 r1c2-t74">The resource is enabled by default. To disable the resource, select false from the dropdown list. You can change this setting in the properties window for the resource.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r4c1-t74" headers="r1c1-t74">
<p>Description</p>
</td>
<td align="left" headers="r4c1-t74 r1c2-t74">Enter a description of the resource. This field is optional.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r5c1-t74" headers="r1c1-t74">Resource Type</td>
<td align="left" headers="r5c1-t74 r1c2-t74">A JMS resource may be either an Admin Object resource or it may be a Connector resource, in which case it is accessed via the Connector API.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r6c1-t74" headers="r1c1-t74">Admin Object Resource</td>
<td align="left" headers="r6c1-t74 r1c2-t74">
<ul>
<li>Check the <code dir="ltr">javax.jms.QueueConnectionFactory</code> radio button if it is a queue.</li>
<li>Check the <code dir="ltr">javax.jms.Topic</code> radio button if it is a topic.</li>
</ul>
</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r7c1-t74" headers="r1c1-t74">Connector Resource</td>
<td align="left" headers="r7c1-t74 r1c2-t74">
<ul>
<li>Check the <code dir="ltr">ConnectionFactory</code> radio button if it is used as a queue.</li>
<li>Check the <code dir="ltr">javax.jms.TopicConnectionFactory</code> radio button if it is used as a topic.</li>
<li>
<p>Check the <code dir="ltr">javax.jms.ConnectionFactory</code> radio button if it is used as a connection factory.</p>
<p><b>Note</b>: With the introduction of the JMS 1.1 specification, it is recommended that you use <code dir="ltr">javax.jms.ConnectionFactory</code> if you do not need to support existing code.</p>
</li>
</ul>
</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<p>The JMS resource properties are added to glassfish-resources.xml. You can open glassfish-resources.xml in the Source Editor by locating the file in your project in the Projects window and double-clicking the file.</p>
<p>Once you have created the object in your project, the resource needs to be registered with the server before you can use it. The resource is automatically registered when you deploy your project.</p>
<a id="NBCSH4846" name="NBCSH4846"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>, 
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG1681">
<param name="text" value="<html><u>&quot;Working with Glassfish Application Servers</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
"</p>

<!-- -->
<!-- Start Footer -->


<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>
